3D Graphics Programming with QuickDraw 3D 1.5.4

Getting Object Positions

QuickDraw 3D provides routines that you can use to find instances of objects in groups.

Q3Group_GetFirstObjectPosition

You can use the Q3Group_GetFirstObjectPosition function to get the position of the first instance of an object in a group.



 
TQ3Status Q3Group_GetFirstObjectPosition (

                     TQ3GroupObject group, 

                     TQ3Object object, 

                     TQ3GroupPosition *position);

group: A group.
object: An object.
position: On exit, a group position.

DESCRIPTION

The Q3Group_GetFirstObjectPosition function returns, in the position parameter, the position of the first instance in the group specified by the group parameter of the object specified by the object parameter.

ERRORS

kQ3ErrorInvalidObject kQ3ErrorNULLParameter

Q3Group_GetLastObjectPosition

You can use the Q3Group_GetLastObjectPosition function to get the position of the last instance of an object in a group.



 
TQ3Status Q3Group_GetLastObjectPosition (

                     TQ3GroupObject group, 

                     TQ3Object object, 

                     TQ3GroupPosition *position);

group: A group.
object: An object.
position: On exit, a group position.

DESCRIPTION

The Q3Group_GetLastObjectPosition function returns, in the position parameter, the position of the last instance in the group specified by the group parameter of the object specified by the object parameter.

ERRORS

kQ3ErrorInvalidObject kQ3ErrorNULLParameter

Q3Group_GetNextObjectPosition

You can use the Q3Group_GetNextObjectPosition function to get the position of the next instance of an object in a group.



 
TQ3Status Q3Group_GetNextObjectPosition (

                     TQ3GroupObject group, 

                     TQ3Object object, 

                     TQ3GroupPosition *position);

group: A group.
object: An object.
position: On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the next instance of the specified object.

DESCRIPTION

The Q3Group_GetNextObjectPosition function returns, in the position parameter, the position of the next instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the last instance of that object in the group, Q3Group_GetNextObjectPosition returns the value NULL in the position parameter.

ERRORS

kQ3ErrorInvalidObject kQ3ErrorInvalidPositionForGroup kQ3ErrorNULLParameter

Q3Group_GetPreviousObjectPosition

You can use the Q3Group_GetPreviousObjectPosition function to get the position of the previous instance of an object in a group.



 
TQ3Status Q3Group_GetPreviousObjectPosition (

                     TQ3GroupObject group, 

                     TQ3Object object, 

                     TQ3GroupPosition *position);

group: A group.
object: An object.
position: On entry, a pointer to a valid group position. On exit, a pointer to the position in the specified group of the previous instance of the specified object.

DESCRIPTION

The Q3Group_GetPreviousObjectPosition function returns, in the position parameter, the position of the previous instance in the group specified by the group parameter of the object specified by the object parameter. If the position specified on entry is the first instance of that object in the group, Q3Group_GetPreviousObjectPosition returns the value NULL in the position parameter.

ERRORS

kQ3ErrorInvalidObject kQ3ErrorInvalidPositionForGroup kQ3ErrorNULLParameter